home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: MegaDisc / MegaDOS - The Amiga DOS Manual (19xx)(MegaDisc Digital Publishing).zip / MegaDOS - The Amiga DOS Manual (19xx)(MegaDisc Digital Publishing).adf / Utilities / Syscheck / syscheck.doc < prev    next >
Text File  |  1985-11-27  |  9KB  |  178 lines
  1.  
  2.  
  3.  
  4.    PROGRAM FOR CHECKING YOU HAVE THE FINAL 1.3 SOFTWARE ON DISK
  5.  
  6.    SysCheck                            Jim Butterfield
  7.    Checks your boot disk, libraries          22-Aug-88
  8.  
  9.    !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  10.  
  11.    [Ed Note: The SYSCHECK program enclosed is dated 14 Oct 1988 and
  12.    handles the final, issued version of V1.3 Workbench. Briefly,
  13.    this program, which must be run from the CLI, will let you check
  14.    any disk or "device" as to whether it has all the FINAL 1.3
  15.    commands and libraries and so forth. In other words, it's here
  16.    so that you don't have to check individual files on individual
  17.    disks. Less pain! more gain! It's basically a case of entering
  18.    in the CLI:
  19.    > syscheck df1:
  20.    and you'll be given a full report. Use the "GOTOCLI" utility -
  21.    just double-click it and you'll have a CLI opening up with this
  22.    directory.]
  23.  
  24.    !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  25.  
  26.  
  27.    So there's a new operating system, Workbench 1.3, and you want
  28.    to bring some of your working programs into the new system.
  29.  
  30.    So you run through the docs, copying in the updated commands,
  31.    libraries and what-have-you.  It's a dirty job, but somebody's
  32.    got to do it.  Which commands and other files need updating?
  33.    Can't do a straight backup or global copy ... to make room on
  34.    working disks, you've had to slice out the unwanted stuff ...
  35.    maybe fonts, or the voice-related stuff (narrator, translator).
  36.  
  37.    To help matters along, there are new commands, libraries and
  38.    stuff (such as FF, or NEWCON-HANDLER) that you need to add.
  39.  
  40.    SYSCHECK doesn't help you a bit with this dreary job.  But it
  41.    might help you check .. to review whether everything is up to
  42.    date, and that the things you left off are MEANT to be left off.
  43.  
  44.  
  45.    SYSCHECK looks through your system libraries, and checks to see
  46.    if each item on its list of 96 files is either:
  47.  
  48.        --Right there and current version (Yay!!!);
  49.        --Missing (OK, if that's what you intended);
  50.        --Not the "current" version (look out!).
  51.  
  52.    Use CLI to call SYSCHECK.  SysCheck is writ in Assembler, and
  53.    is pure (Pure what?) so you can make it resident and check four
  54.    disks at a time.  If desired.   Syntax:  SysCheck (<device>)
  55.  
  56.    Examples:  SysCheck            scans current directory
  57.               SysCheck DF0:       scans DF0:
  58.               SysCheck RAM:       ..huh?
  59.  
  60.                  ..well, OK on that last one if you REALLY put your
  61.    system in RAM: .. but mostly folks would get a lot of MISSING
  62.    messages on that one.
  63.  
  64.       And of course, you could use DF1: or hard disk or whatever
  65.    your finanaces or fairy godmother have provided.
  66.  
  67.    Output goes to the screen.  Use redirection if you want it to go
  68.    elsewhere, e.g.:
  69.              SysCheck >ram:SCFile df1:
  70.                     You get two reports .. one, as it's going through
  71.    the files (alphabetic order, more or less).  This part goes to a
  72.    CON: screen, and won't be redirected.  Then you'll get the results:
  73.    separate lists of the three categories.
  74.  
  75.    Let's look at the three possibilities:
  76.        --Right there and current version (Yay!!!).  The file matches
  77.    the one the program knows.  It could be a brand new 1.3 version;
  78.    it might be unchanged since 1.0 (not too many of those around).
  79.    In any case, it's up to date as far as SYSCHECK is concerned.
  80.        --Missing (OK, if that's what you intended).  Everybody strips
  81.    away the files they don't plan to use.  If you know why this file
  82.    is missing, rest easy.  If you missed it due to an oversight, copy
  83.    it over.  If it's "new for 1.3", decide if you need it.
  84.        --Not the "current" version (look out!).  Maybe it's an old
  85.    version, and you should have updated it.  Maybe it's so brand-new
  86.    that this program hasn't heard about it.  Or.. it could be a
  87.    "poisoned" file.  Do you know where your disk has been?
  88.  
  89.    Uses of SYSCHECK:
  90.     --checking that a system you've just updated to 1.3 is OK.
  91.     --examining a 1.2 disk, not because you care, but because you're
  92.    curious as to what has changed.
  93.     --looking at a "foreign" disk - one you've just received from
  94.    someone else - to see if the libraries are up to date.
  95.     --examining new Commodore releases to see if they have slipped
  96.    in any changes, and where.
  97.  
  98.    What is Checked:
  99.       Almost everything in the C directory.  Most of L and LIBS, and
  100.    some items from SYSTEM and UTILITIES.
  101.  
  102.    What is Not Checked:
  103.       Things that are often customized, such as FONTS, DEVS and S
  104.    scripts.  I'm leaving PREFERENCES alone, too, together with the
  105.    SYSTEM-CONFIGURATION file.  No point in getting Change messages
  106.    when changes will be commonplace and unimportant.
  107.       Watch the "version" title.  Commodore may change things, and the
  108.    new versions won't be recognized until SysCheck is updated.
  109.       SYSCHECK does not examine the boot block area.
  110.  
  111.    Computer Vandalism?
  112.       Hopefully, you know now about nerds who vandalize computers
  113.    with viruses (virii?) and other horrors.  And you know to use
  114.    utilties such as VCheck1.9 to check whether your disks have been
  115.    subjected to such brainless damage.  Such damage takes place in
  116.    the "boot block".  SYSCHECK will not spot any changes there;
  117.    use a good virus checker.
  118.       Seems to me that the next attack of the mutants could be by
  119.    changing the CLI commands or the libraries.  It would not take
  120.    much brains - only a level of sociopathy - to replace, say, the
  121.    DIR command with a "sport" that will delete every tenth file,
  122.    and that will copy itself into any new C directory it finds.
  123.       In spotting changes in the system directories, SYSCHECK will
  124.    help guard against such practices.  They would be nasty enough
  125.    on floppies .. but a hard disk system could be seriously harmed
  126.    by such file-fiddling.
  127.       DO look through files such as your S/Startup-Sequence to make
  128.    sure you know what all the commands in there are supposed to be
  129.    doing.  It would be possible for one of the great Brain-Damaged
  130.    to slip something nasty in there.
  131.  
  132.  
  133.    On the Brighter Side...
  134.       SYSCHECK is not intended primarily as a doomsday-detector.
  135.    It is there mostly to help you keep things up to date...
  136.     ...until SYSCHECK itself goes out of date by being succeeded by
  137.    revised libraries.
  138.  
  139.    The 1.3 Update...
  140.       So you've gotten the 1.3 system, and are ready to bring your
  141.    software into the current generation.  Good for you.  The following
  142.    descriptions use the new 1.3 commands, and assume drive DF1:
  143.    contains the disk you're checking.  Best to boot up
  144.    on Workbench 1.3 (a backup, please!), and then command:
  145.    RESIDENT C:INSTALL (and ...C:INFO and ...C:COPY and ...C:DIR and
  146.    even ...SysCheck/SysCheck).
  147.       Test your working disk, the one you're about to upgrade, with
  148.    INSTALL DF0: CHECK.  A report of a "non-standard boot" indicates
  149.    that it's either copy-protected or has acquired a virus; ask for
  150.    help on these.  Otherwise, make a backup of this disk.  Now run a
  151.    directory of this disk.  Use INFO to see how full the disk is.
  152.    Many commercial disks are jammed full, and the new 1.3 files will
  153.    often be bigger than the old ones.  You could run out of space
  154.    on the upgraded disk; plan for this possibility.
  155.  
  156.       Run SYSCHECK and update anything marked NOT CURRENT VERSION.
  157.    Use the CLONE feature of COPY (new for 1.3) when you do this.
  158.    If the disk is nearly full, think of what might be removed:
  159.    for example, if this program group doesn't speak, you won't need
  160.    LIBS:TRANSLATOR.LIBRARY or L:SPEAK-HANDLER.  If you don't use
  161.    fonts, you may be able to junk that whole library, along with
  162.    LIBS:DISKFONT.LIBRARY.  Go through the DEVS:PRINTERS libraries
  163.    and throw out the printer drivers you don't use (important:  be
  164.    sure to update the ones you DO use from the 1.3 disk).
  165.  
  166.       Another run of SYSCHECK will show all files current, but some
  167.    MISSING.  Here's where you have to make hard system decisions.
  168.    If you use CLI, be sure to add L:NEWCON-HANDLER and L:SHELL-SEG,
  169.    along with C:NEWSHELL and S:SHELL-STARTUP.  While we're in S:
  170.    let's look at the Startup-Sequence:  as a minimum, you should
  171.    add the new 1.3 title to your existing file.  Snoop the new
  172.    Startup-Sequence file for thoughts on further updates; you'll
  173.    see that this file has split into two (the second called StartupII).
  174.    Use what seems sensible.
  175.  
  176.  
  177.    ###################### END OF SYSCHECK.DOC ###########################
  178.